Getting started with SWS

Prerequisites

• Installed Java Development Kit (JDK)
• Installed Integrated development environment (IDE) (e.g. Eclipse)
• Installed or downloaded Simple Web Server SWS and a project / source code that depends on the downloaded JAR files.

First program: Hello world

public class Sample01HelloWorld extends WebPage implements Sample01HelloWorldFunctionList {

    public void index();

    @Override
    public void index() {
        HtmlOutput htmlOutput = HtmlOutput.getHtmlOutput();
        htmlOutput.writeTitle("Sample 01 - Hello World - Web page");
        htmlOutput.writeHeader("Hello World", 1);
        htmlOutput.writeText("If you see this it's working.");
    }

    public static void main(String[] args) {
        SimpleWebServer.runServer(8080, new Sample01HelloWorld());
    }

import sws.html.HtmlOutput;
import sws.server.SimpleWebServer;
import sws.structure.WebPage;

public class Sample01HelloWorld extends WebPage implements Sample01HelloWorldFunctionList {
    public static void main(String[] args) {
        SimpleWebServer.runServer(8080, new Sample01HelloWorld());
    }
    
    @Override
    public void index() {
        HtmlOutput htmlOutput = HtmlOutput.getHtmlOutput();
        htmlOutput.writeTitle("Sample 01 - Hello World - Web page");
        htmlOutput.writeHeader("Hello World", 1);
        htmlOutput.writeText("If you see this it's working.");
    }
}

Server is running on:
http://localhost:8080/

Hello World

Definitions

Simple Web Server

Web directory

Web application

Scheduled tasks

Web resource

Web page

(Web) page function

Function list

Form object

Data object

Property list

Program 2: Simple link

public class Sample02SimpleLink extends WebPage implements Sample02SimpleLinkFunctionList {

    public void index();
    public void pageFunction2();

    @Override
    public void index() {
        HtmlOutput htmlOutput = HtmlOutput.getHtmlOutput();
        htmlOutput.writeTitle("Sample 02 - Simple link - Web page");
        htmlOutput.writeHeader("Simple link", 1);
        htmlOutput.writeText("This sample shows how to link to another page (Page function).");
        htmlOutput.writeBreakLine();
        htmlOutput.writeBreakLine();
        
        // This will write a link to the "pageFunction2" page function into the htmlOutput.
        // Note: The first parameter is not the class ("Sample02SimpleLink") of the page function. It is the interface (The function list) that defines the page function.
        // Note: The method pageFunction2() is not called here. It is first called when the user clicks on the link, that this code writes / generates.
        htmlOutput.writeLink(Sample02SimpleLinkFunctionList.class, "This is the label of the link").pageFunction2();
        
        htmlOutput.writeBreakLine();
    }

    @Override
    public void pageFunction2() {
        HtmlOutput htmlOutput = HtmlOutput.getHtmlOutput();
        htmlOutput.writeTitle("Sample 02 - Simple link - Web page - pageFunction2");
        htmlOutput.writeHeader("Simple link", 1);
        
        htmlOutput.writeText("Congratulations you have clicked on the link.");
    }

    public static void main(String[] args) {
        SimpleWebServer.runServer(8080, new Sample02SimpleLink());
    }

Program 3: Simple object update

import sws.html.HtmlOutput;
import sws.server.SimpleWebServer;
import sws.structure.WebPage;

public class Sample03SimpleObjectUpdateWebPage extends WebPage implements Sample03SimpleObjectUpdateWebPageFunctionList {
    public static void main(String[] args) {
        SimpleWebServer.runServer(8080, new Sample03SimpleObjectUpdateWebPage());
    }
    
    // This is the object that is updated.
    // Note: There will only be one instance of this object, which will shared between users. (It is a singleton)
    private Sample03SimpleObjectUpdateData sample03SimpleObjectUpdateData = new Sample03SimpleObjectUpdateData();

    @Override
    public void index() {
        HtmlOutput htmlOutput = HtmlOutput.getHtmlOutput();
        htmlOutput.writeTitle("Sample 03 - Simple object update - Web page");
        htmlOutput.writeHeader("Simple object update", 1);
        htmlOutput.startCenter();
        
        // This will write the start of a HTML form tag into the htmlOutput.
        // The first parameter (Sample03SimpleObjectUpdateWebPageFunctionList.class) combined with the method "call" in the end (saveData) 
        // defines the submit (The "action" attribute of the HTML form tag) page function. 
        // This page function / method will not be called here (Similar to a link). It will first be called when the user clicks the submit button.
        // Note: The first parameter is not the class ("Sample03SimpleObjectUpdateWebPage") of the page function.
        // It is the interface (The function list) that defines the page function.
        // The second parameter (sample03SimpleObjectUpdateData) is the form object (This parameter is optional).
        // The form object is the object that will (as default) be updated by the form. I.e. data displayed is "get" from and updates are "set" to this object.
        htmlOutput.startForm(Sample03SimpleObjectUpdateWebPageFunctionList.class, sample03SimpleObjectUpdateData).saveData();
        
        htmlOutput.writeLabelForNextInputField("Text field ");
        
        // This will write a input tag with the type attribute set to "text" into the htmlOutput.
        // The value in this input tag field is found by calling the getTextField method on the form object (Defined by the startForm method call. See above).
        // When the user submits (Clicks the submit button) the form, the data in this field are then updated back into the form object using the setTextField method.
        // Note: The first parameter is NOT the form object nor the class of it. It is the interface that the form object implements. 
        htmlOutput.writeTextInputFieldAndAssociateItWith(Sample03SimpleObjectUpdateDataPropertyList.class).getTextField();
        
        // This will write a submit button (input tag with type attribute set to "submit") with the label "Save data" into the htmlOutput.
        htmlOutput.writeSubmitButton("Save data");
        
        htmlOutput.endForm();
        htmlOutput.endCenter();
    }

    @Override
    public void saveData() {
        HtmlOutput htmlOutput = HtmlOutput.getHtmlOutput();
        htmlOutput.writeTitle("Sample 03 - Simple object update - Web page");
        htmlOutput.writeHeader("Data saved", 1);
        htmlOutput.writeText("The text field was updated to contain: \"" + sample03SimpleObjectUpdateData.getTextField() + "\"");
        htmlOutput.writeBreakLine();
        htmlOutput.writeBreakLine();
        htmlOutput.writeLink(Sample03SimpleObjectUpdateWebPageFunctionList.class, "Back").index();
    }
}

        htmlOutput.startForm(Sample03SimpleObjectUpdateWebPageFunctionList.class, sample03SimpleObjectUpdateData).saveData();

        htmlOutput.writeTextInputFieldAndAssociateItWith(Sample03SimpleObjectUpdateDataPropertyList.class).getTextField();

import java.io.Serializable;

public class Sample03SimpleObjectUpdateData implements Sample03SimpleObjectUpdateDataPropertyList, Serializable {
    private static final long serialVersionUID = -4323935484447061760L;
    
    private String textField;

    @Override
    public String getTextField() {
        return textField;
    }

    public void setTextField(String ptextField) {
        textField = ptextField;
    }
}

The next programs